home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbzippy.zip / PCBZIPPY.DOC next >
Text File  |  1992-09-20  |  5KB  |  132 lines

  1. ****  PCB-Zippy   A zippy scan emulator for PB-Board captured file listings  ****
  2.  
  3.                            (c) 1992 Michael Ottoson
  4.  
  5.  
  6. Shareware registration:  $10.00 (plus $2 S&H)
  7.  
  8.  
  9.         Packing List:   PCBZIPPY.DOC    This file
  10.                         Z.EXE           The program
  11.                         SHARWARE.DOC    A file about Shareware
  12.  
  13.         
  14. Here's the problem:  You just captured the file listings from your
  15. favourite PC-Board BBS.  You want a list of all the ATM fonts
  16. availabe (for example), but when you use your text viewer's search for
  17. "font" you get all the HP fonts mixed in, and you miss all the entries
  18. that have "ATM" without the word "font".
  19.  
  20. When you're on-line it's no problem because you can use the zippy scan
  21. to narrow your search with ANDs and ORs and such.  Don't you wish you could
  22. use PC-Board's zippy scan on your capture files?
  23.  
  24.             . . . WELL NOW YOU CAN -- THANKS TO *PCB-Zippy*
  25.  
  26. Here's how it works:
  27.  
  28.  
  29. Syntax:   z  test pattern  filename  [-options]
  30.  
  31. **The operators to narrow your search are:  & (and)  # (or)  ! (not)
  32.  
  33. **The  test pattern  includes all search items and operators.
  34.  
  35. **You can scan any number of items, from one to nine separate elements,
  36.   separated by any combination of operators.
  37.  
  38.  
  39.   In the above example, you could use "Z" from the command line
  40.   like this:
  41.  
  42.   z atm#font !HP capture.cap
  43.  
  44.   This would list all the files in your capture file (eg capture.cap)
  45.   that have either "atm" OR "font" but will not list any that have "HP"
  46.  
  47. The command line options must come after the filename, and must start
  48. with a hyphen (-).  The options available with this release are:
  49.  
  50.    -a      List all files
  51.    -@      Case sensitive search (default non-case sensitive)
  52.  
  53.    -cN     Colour switch, N: 0=off, 1=on (default ON) needs ANSI.SYS
  54.    -n      Non-stop listing (default pause for screenful)
  55.  
  56.    -f      For redirected outputs (">") (read DOS manual for more info
  57.                                          on redirecting output to other
  58.            (Non-registered only)         than screen)
  59.  
  60. If you have both -a and a test pattern, all files will still be listed.
  61.  
  62. The -f switch in the non-registered version is used if you wish to use
  63. the DOS redirected output ">" to send the listing to a file or to the
  64. printer.  You must use this switch for redirected outputs or things may
  65. not work right.  Eg:  If you wanted to print the list from the above example,
  66. you could use:
  67.                z  atm#font !HP  capture.cap  -f > LPT1
  68.                                                 ^^^^
  69. Change LPT1 to the name of a file, and that's where your listing will go.
  70.  
  71. ---------------[Extra options with registered version]-------------------
  72.  
  73.    -b:     Search by byte size.  Use + for over, - for under, = equal
  74.            to.  eg:  -b:-102400 would only list files under 100K.
  75.  
  76.    -d:     Search by date.  As above, use +, - ,= before date. (I
  77.            know, I know, who would really need the =?  Since I had the
  78.            + and the -, it was easy to add the = for the sake of
  79.            symetry.  Aren't you interested if there are any filed
  80.            dated on your birthday?)  Format for date: MM-DD-YY.  For
  81.            example -d:+05-15-92 would only list files dated on or
  82.            later than May 16, 1992.
  83.  
  84.    NOTE:  -b: and -d: must be used with either a test pattern or -a.
  85.  
  86.    -f:     List to filename.  Eg:  -f:output.txt
  87.    -p      List to printer (uses PRN)  (-f: and -p replace the old
  88.            "redirect" switch -f from the non-registered version)
  89.  
  90.       Other improvements in the registered version are improved full
  91.       screen handling.  If the screen fills and only a portion of the
  92.       description is showing, flashing +++'s will appear to notify
  93.       you of this.  You can then (J)ump to the end of the description.
  94.       You can use (J)ump repeatedly to view on description at a time.
  95.  
  96.       Also, in the non-registered version, you couldn't pause the list once
  97.       NonStop is selected (either from the command line or from the screen
  98.       full menu)  Now just hit any key and you will be given the full
  99.       screen menu.
  100.  
  101.  
  102. Final notes:
  103.  
  104. *****   The only spaces that are required are one space before the
  105.         filename and any spaces between the option switches.  Spaces
  106.         within the test pattern are ignored.
  107.  
  108. *****   Don't use parentheses.  This version doesn't support them.
  109.         You can usually rewrite the order your operators such that you
  110.         don't really need them.  I'll try to support parentheses in
  111.         the next release.
  112.  
  113. *****   In case you're wondering why # is OR, it's because the | is
  114.         reserved in DOS for pipes.  Similarly, I used +,- instead of
  115.         >,< for byte and date searches because of DOS redirects.
  116.  
  117. *****   This program is Shareware.  If you continue to use this program
  118.         after 30 days, you must send $10.00 (plus $2 S&H) to the author
  119.         at the address below.  This will entitle you the next release free,
  120.         and a good conscience.
  121.  
  122. *****   Special thanks to Marc Durocher, beta-tester extraordinaire
  123.         and all around nagger, and to Gary Lapierre for running the
  124.         greatest igloo based BBS this side of the Arctic Circle.
  125.  
  126.         Address suggestions and registration fees to:
  127.  
  128.              Michael Ottoson
  129.              141 Birch St. N.
  130.              Timmins, Ontario
  131.              P4N 6E3
  132.